نحن بصدد تعديل Data API لتتطابق مع طريقة YouTube في احتساب مشاهدات Shorts.
مزيد من المعلومات
التنفيذ: التقييمات
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
توضّح الأمثلة التالية كيفية استخدام YouTube Data API (الإصدار 3) لتنفيذ وظائف ذات صلة بتقييمات الفيديوهات.
تقييم فيديو
استخدِم الطريقة videos.rate لإرسال تقييم مستخدم لفيديو. يجب تفويض هذا الطلب باستخدام بروتوكول OAuth 2.0.
اضبط المَعلمتَين التاليتَين في طلبك:
- تحدّد المَعلمة
id معرّف الفيديو على YouTube الذي يتم تقييمه (أو إزالة تقييمه).
- تحدّد المَعلمة
rating التقييم الذي يريد المستخدم الذي يمنح الإذن بالطلب تسجيله. قيم المَعلمات الصالحة هي like وdislike وnone. تحدّد القيمتَان الأولى والثانية تقييمًا، وتزيل القيمة الثالثة أي تقييم سابق للمستخدم.
يقدّم نموذج الطلب أدناه تقييمًا إيجابيًا (إعجاب) لفيديو الكلمة الرئيسية في مؤتمر Google I/O لعام 2014:
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.rate?
id=wtLJPvx7-ys
&rating=like
استرداد تقييم المستخدم الحالي لفيديو
تتيح لك طريقة videos.getRating استرداد تقييم المستخدِم الذي تمّت المصادقة عليه حاليًا لفيديو واحد أو أكثر. في طلبك، اضبط قيمة المَعلمة id على قائمة مفصولة بفواصل لمعرّفات فيديوهات YouTube للموارد التي تسترجع بيانات التقييمات لها. يُرجى العِلم أنّه يجب تفويض هذا الطلب باستخدام بروتوكول OAuth 2.0.
يستردّ نموذج الطلب أدناه تقييم المستخدم الحالي لفيديو الكلمة الرئيسية في مؤتمر Google I/O لعام 2014. (إذا نفّذت المثال السابق في "مستكشف واجهات برمجة التطبيقات"، من المفترض أن يشير ردّ واجهة برمجة التطبيقات إلى أنّ التقييم هو like.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.getRating?
id=wtLJPvx7-ys
استرداد الفيديوهات التي قيّمها المستخدم الحالي
تتيح لك مَعلمة myRating في الطريقة videos.list استرداد قائمة بالفيديوهات التي صنّفها المستخدم الذي يمنح الإذن بطلب البيانات من واجهة برمجة التطبيقات. تشير قيمة المَعلمة إلى ما إذا كنت تريد استرداد الفيديوهات التي أعجبتك أو لم تعجبك.
يسترجع نموذج الطلب أدناه قائمة بالفيديوهات التي منح المستخدم الحالي تقييم like لها. يجب تفويض الطلب باستخدام OAuth 2.0.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.list?
part=snippet
&myRating=like
ملاحظة: يمكنك أيضًا استرداد قائمة بالفيديوهات التي أعجبت المستخدم (وليس الفيديوهات التي لم تعجبه) باتّباع الخطوات الواردة في مقالة
استرداد الفيديوهات المفضّلة للقناة. في الخطوة 1 من هذه العملية، بدلاً من استرداد معرّف قائمة التشغيل للفيديوهات المفضّلة للقناة، استردّ معرّف قائمة التشغيل للفيديوهات التي أعجبت المستخدم في القناة. تحتوي السمة
contentDetails.relatedPlaylists.likes على القيمة.
وبالتالي، تسمح لك واجهة برمجة التطبيقات باسترداد قائمة بالفيديوهات التي أعجب بها المستخدم باستخدام الطريقة
videos.list أو الطريقة
playlistItems.list. بما أنّه يتم عرض معلومات مختلفة في مورد
video عن مورد
playlistItem، يمكنك اختيار الطريقة التي تناسب احتياجاتك على أفضل وجه.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-11-23 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2024-11-23 (حسب التوقيت العالمي المتفَّق عليه)"],[[["The YouTube Data API (v3) allows users to rate videos using the `videos.rate` method, with options to `like`, `dislike`, or remove a rating (`none`), requiring OAuth 2.0 authorization."],["You can retrieve the currently authenticated user's rating for specific videos by using the `videos.getRating` method and providing a comma-separated list of video IDs, also requiring OAuth 2.0."],["The API enables the retrieval of a list of videos rated by the current user, either liked or disliked, through the `videos.list` method and its `myRating` parameter, which also requires OAuth 2.0."],["Alternatively, users can retrieve a list of their liked videos by using the `playlistItems.list` method and accessing the `contentDetails.relatedPlaylists.likes` property, which offers an alternative to the `videos.list` method."]]],["The YouTube Data API (v3) facilitates video rating management. Using `videos.rate`, users can set or remove ratings (`like`, `dislike`, `none`) for specific videos via the `id` and `rating` parameters. `videos.getRating` retrieves a user's rating for videos, referencing video IDs. The `videos.list` method, with the `myRating` parameter, fetches videos the user has rated as \"like\", and similar functionality is available via the `playlistItems.list` method. All requests require OAuth 2.0 authorization.\n"]]
